home *** CD-ROM | disk | FTP | other *** search
/ Virtual Communities Companion / Virtual Communities Companion.iso / disk1 / wwwboard / admin_readme next >
Encoding:
Text File  |  1997-07-29  |  7.4 KB  |  143 lines
  1. ##############################################################################
  2. # WWWBoard Admin                Version 2.0 ALPHA 2                          #
  3. # Copyright 1996 Matt Wright    mattw@worldwidemart.com                      #
  4. # Created 10/21/95              Last Modified 11/25/95                       #
  5. # Scripts Archive at:           http://www.worldwidemart.com/scripts/        #
  6. ##############################################################################
  7. # COPYRIGHT NOTICE                                                           #
  8. # Copyright 1996 Matthew M. Wright  All Rights Reserved.                     #
  9. #                                                                            #
  10. # WWWBoard may be used and modified free of charge by anyone so long as      #
  11. # this copyright notice and the comments above remain intact.  By using this #
  12. # code you agree to indemnify Matthew M. Wright from any liability that      #  
  13. # might arise from it's use.                                                 #  
  14. #                                                                            #
  15. # Selling the code for this program without prior written consent is         #
  16. # expressly forbidden.  In other words, please ask first before you try and  #
  17. # make money off of my program.                                              #
  18. #                                                                            #
  19. # Obtain permission before redistributing this software over the Internet or #
  20. # in any other medium.  In all cases copyright and header must remain intact.#
  21. ##############################################################################
  22.  
  23. WWWAdmin is finally here!  I know it used to be a pain to have to maintain 
  24. WWWBoard without a program, so I am currently developing WWWAdmin.  Right 
  25. now it performs the basic functions, which allow you to remove messages and 
  26. change your password.  I will explain each different process and how to set
  27. up this program below.  I will also list some of the features you can expect
  28. in upcoming releases.
  29.  
  30. The variables and options in WWWAdmin should correspond directly to those in 
  31. WWWBoard.  In all except two cases, you can copy the variables out of 
  32. wwwboard.pl and place them in wwwadmin.pl.  There is one new variable in 
  33. wwwadmin.pl and one variable that will need to be changed:
  34.  
  35.     $cgi_url = "http://your.host.xxx/cgi-bin/wwwadmin.pl";
  36.         This variable needs to be changed from the url to 
  37.        wwwboard.pl to the url to wwwadmin.pl.  This may simply mean 
  38.        changing the file name at the end of the url.
  39.  
  40.     $passwd_file = "passwd.txt";
  41.         This is a new variable and simply gives the filename of the 
  42.        password file in relation to $basedir.  So if you place this 
  43.        file in $basedir, you can simply set this variable equal to the 
  44.        filename, which is most commonly passwd.txt
  45. ____________________________________________________________________________
  46.  
  47. RUNNING WWWADMIN.
  48.     WWWAdmin is a self-contained script, in that all you have to do is 
  49.    call the script with a plain url (The url you used in $cgi_url) and it 
  50.    will give you a form which displays all of your options.  The options 
  51.    that are currently available in this release are:
  52.     Remove Messages
  53.     Remove Messages by Date
  54.     Remove Messages by Author
  55.     Remove Messages by Sorted Number
  56.     Change WWWAdmin Password
  57.  
  58. All of these options require you to use a password and username once you 
  59. take the link.  The default username and password for WWWAdmin are:
  60.  
  61. Username: WebAdmin
  62. Password: WebBoard
  63.  
  64. They are case sensitive, so make sure you type them in correctly.  I suggest 
  65. you jump down to the explanation on Changing WWWAdmin Password before 
  66. you make this wwwboard available to the public.  A brief description of 
  67. how each WWWAdmin function works is below:
  68.  
  69. REMOVE MESSAGES
  70. ===============
  71.     When selecting this link, you will be taken to a form which gives you 
  72. the article number, two radio boxes, the subject, author and date that 
  73. the article was posted, for all articles.  The form is put inside of a 
  74. Netscape table, but I have tested it and it also works with lynx (a text 
  75. based browser) so I am sure it will work with others.  You can check the 
  76. radio boxes to the side of the messages that you wish to remove from 
  77. your WWWBoard.  Checking the check box to the left, will remove the 
  78. entire thread, while checking the check box on the right, simply removes 
  79. that single posting, whether it is imbeded in a thread or not.  This 
  80. will also remove the message out of your messages/ directory, and if you 
  81. select to remove the thread, it will remove all messages in that thread 
  82. out of your messages/ directory.
  83.  
  84. REMOVE MESSAGES BY DATE
  85. =======================
  86.     This link will pop up a form that looks something like this:
  87.  
  88.   Checkbox   Date1   # of Messages  Message Numbers
  89.  
  90. You can click in the checkbox next to any dates of your choice and it 
  91. will remove all files that were posted on that date.  To see what files 
  92. are going to be removed and how many, you can look at the columns 
  93. labeled # of messages and message numbers.  If messages of an earlier 
  94. date happen to be at the head of a thread, they will be removed and the 
  95. next response down in the thread becomes the head of that thread.  It 
  96. will only remove messages with that date.
  97.  
  98. REMOVE MESSAGES BY AUTHOR
  99. =========================
  100.     This link will pop up a form very similar to that which the Remove 
  101. Message by Date link brought up.  Except instead of different dates, you 
  102. will see the names of authors of messages.  You can check the checkbox 
  103. next to an authors name to remove all postings that he or she posted to 
  104. your message board.
  105.  
  106. REMOVE MESSAGES BY SORTED NUMBER
  107. ================================
  108.     This link brings up a form identical to the plain Remove Messages form, 
  109. except that the postings are sorted from lowest number to highest 
  110. number.  This can be useful if you want to delete postings in the order 
  111. they were posted, but this is probably the l east useful remove function.
  112.  
  113. CHANGE PASSWORD
  114. ===============
  115.     This form will ask you to fill in your current username and password 
  116. and allow you to change your username and password to whatever you 
  117. like.  If you want to keep the username the same, you can simply not 
  118. fill in the 'New Username' part of the script.  When changing your 
  119. password, which I suggest you do right when you get WWWAdmin working, 
  120. you will need to type the new password two times in a row, just to make 
  121. sure you don't mis-type it.  Then, hit submit and if you input the 
  122. correct old username and password, you will be given a response that 
  123. tells you the new username and password.  Do not forget your password, 
  124. because it will be encrypted in the passwd.txt file, just like your Unix 
  125. login password.  You will need to re-download the wwwadmin tool...
  126. __________________________________________________________________________
  127.  
  128. FUTURE FEATURES
  129. ===============
  130.     I will continue to work on this admin tool and hopefully make it much 
  131. more powerful.  To do this, I need to know what you would like to be 
  132. able to do with it.  Some of my ideas include being able to edit any 
  133. post, and possibly moving them around in hierarchies.  Let me know what 
  134. else you would like to see this thing do.
  135. __________________________________________________________________________
  136.  
  137. HISTORY
  138.  
  139. Version 2.0 A2    - 11/25/95    - Released WWWAdmin Tool with WWWBoard 2.0
  140.                   ALPHA 2
  141. __________________________________________________________________________
  142. Matt Wright - mattw@worldwidemart.com
  143.